home *** CD-ROM | disk | FTP | other *** search
/ User's Choice Windows CD / User's Choice Windows CD (CMS Software)(1993).iso / win_m_p / mbar.zip / MENUBAR.TXT < prev    next >
Text File  |  1992-02-25  |  16KB  |  402 lines

  1.  
  2.  
  3.                      MENUBAR Toolbar Program
  4.  
  5.                           Users manual 
  6.                          Release  1.00 
  7.  
  8.                         February 28, 1992
  9.                        Copyright (c) 1992 
  10.  
  11.                               by  
  12.   
  13.                               MRL 
  14.   
  15.                         1200 Stonehurst 
  16.                    Huntsville, Alabama 35801  
  17.                                  
  18.                        All Rights Reserved
  19.  
  20. This file provides the information needed to utilize the shareware
  21. distribution version of the MENUBAR program. MENUBAR is a
  22. copyrighted product of MRL and all rights are reserved. Any and all
  23. usage must be in accordance with terms discussed in section III of
  24. this documentation. No usage other than for evaluation is permitted
  25. without registration. User feedback including comments/questions
  26. are welcome. Please address your comments to MRL via Compuserve
  27. electronic mail at user id [73637,737] or via mail to 1200
  28. Stonehurst, Huntsville, AL., 35801. 
  29.  
  30.  
  31.                   Restrictions and Warranties
  32.  
  33. The software described herein is furnished under a license
  34. agreement. The software may be used or copied only in accordance
  35. with the terms of the applicable agreement. The purchaser may make
  36. one copy of the software for backup purposes. Unregistered copies
  37. of MENUBAR are for evaluation purposes only, and may be distributed
  38. through normal shareware channels.  Please distribute these
  39. evaluation copies to other bulletin boards and users. MENUBAR may
  40. be uploaded to and downloaded from commercial systems such as
  41. CompuServe, the Source, and BIX, as long as there is no charge for
  42. the product itself.  Those copying, sharing, and/or electronically
  43. transmitting this product are required not to delete or modify the
  44. copyright notice and restrictive notices from the program or
  45. documentation. Any distribution of MENUBAR must include all files
  46. contained in the packed format. Commercial vendors and distributors
  47. of "public domain" or user-supported software libraries may
  48. distribute copies of MENUBAR unless notified by MRL to cease
  49. distribution of the product. Only nominal fees associated with
  50. copying and handling (not to exceed $5 US) may be charged by anyone
  51. providing unregistered copies. MENUBAR may not be utilized or
  52. distributed as a promotion for any commercial venture. 
  53.  
  54. Information in this document is subject to change without notice
  55. and does not represent a commitment on the part of MRL. 
  56.  
  57. To use MENUBAR, you need the following:
  58.   
  59.           IBM PC (or compatible)-286 with 1 Mbyte. 
  60.  
  61.           Microsoft Windows (version 3.0 or later)  
  62.   
  63.           MS-DOS/PC-DOS (version 3.0 or a later version required
  64.           by your version of Microsoft Windows)  
  65.   
  66. Use of this product for any period of time constitutes your 
  67. acceptance of this agreement and subjects you to its contents.   
  68.  
  69.   
  70. EXCEPT AS PROVIDED IN PART III OF THIS MANUAL, MRL DISCLAIMS ALL 
  71. WARRANTIES, EITHER EXPRESS OR IMPLIED, INCLUDING, BUT NOT LIMITED
  72. TO IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A
  73. PARTICULAR PURPOSE, WITH RESPECT TO THE PRODUCT. SHOULD THE PROGRAM
  74. PROVE DEFECTIVE, THE PURCHASER ASSUMES THE RISK OF PAYING THE
  75. ENTIRE COST OF ALL NECESSARY SERVICING, REPAIR, OR CORRECTION AND
  76. ANY INCIDENTAL OR CONSEQUENTIAL DAMAGES.  IN NO EVENT WILL MRL BE
  77. LIABLE FOR ANY DAMAGES WHATSOEVER (INCLUDING WITHOUT LIMITATION
  78. DAMAGES FOR LOSS OF BUSINESS PROFITS, BUSINESS INTERRUPTION, LOSS
  79. OF BUSINESS INFORMATION AND THE LIKE) ARISING OUT OF THE USE OR THE
  80. INABILITY TO USE THIS PRODUCT. 
  81.  
  82.  
  83.  
  84.                            I. CONCEPT
  85.  
  86. MENUBAR may be utilized with MS Windows to customize the user
  87. environment by addition of menubars (or toolbars) that specify a
  88. user selected icon/bitmap file and associate this file with an
  89. executable programs. MENUBAR provides a capability to define
  90. toolbar controls that augment existing execution methods or create
  91. a complete desktop environment based on the users own preferences. 
  92.  
  93.  
  94.  
  95.  
  96.                            II. Specification of Options
  97.  
  98. This section describes how the user creates and selects the MENUBAR
  99. capabilities. Three command line functions are described in the
  100. following sections, with the additional sections describing the
  101. dialogue interaction necessary to edit or create a menubar and
  102. mouse/key usage.
  103.  
  104. 1.0 Execution of an existing menubar definition.
  105.  
  106. The user may execute a previously defined menubar definition by
  107. providing the definition name as the first parameter of the command
  108. line. Note that each menubar definition is stored as a separate
  109. MSDOS file. If the user does not specify the MSDOS filename
  110. extension, MENUBAR creates this with the extension .mbr. The
  111. command to execute an existing definition is menubar xxx, where xxx
  112. is the menubar definition name. xxx must conform to the filename
  113. portion of the MSDOS naming conventions. When utilizing Program
  114. Manager for execution, it is recommended that the pathname be
  115. included as part of both the program name and definition name. For
  116. example "c:\menubar\menubar.exe c:\data\menu1" would execute the
  117. MENUBAR program from directory c:\menubar and use the menu1
  118. definition form the MSDOS file c:\data\menu1.mbr. The default
  119. pathname for bitmap/icon files is the pathname provided for the
  120. definition file.
  121.  
  122. To utilize a menubar as part of windows startup, the win.ini file
  123. should be modified as follows:
  124.  
  125. 1)    Add to Extensions section mbr=xxx\menubar.exe yyy\^.mbr
  126.  
  127. where xxx is the MENUBAR program directory and yyy is the directory
  128. containing the .mbr files.
  129.  
  130. 2) Add to Windows section run=xxxx.mbr
  131.  
  132. where xxxx is the desired menubar name.
  133.  
  134. MENUBAR is not configured to replace the Windows program manager.
  135.  
  136. 2.0 Creating a new menu definition.
  137.  
  138. The user creates a new definition file by entering the menubar
  139. command without any parameters. A Message Box will confirm that
  140. this was the intended action, and then a data dialogue will be
  141. provided for entry of the definition name. The detailed definition
  142. dialogues (see section 4.0) are then provided for specification of
  143. the characteristics.
  144.  
  145. 3.0 Editing an existing definition
  146.  
  147. The user may edit an existing definition by specifying the -E
  148. parameter followed by the definition name. For example
  149. "menubar -E  menu1" would edit the menu1.mbr file in the current
  150. directory. The detailed dialogues (see section 4.0) are displayed
  151. to allow for changing the current characteristics.
  152.  
  153. 4.0 Detailed characteristics
  154.  
  155. This Section describes three detailed dialogues for definition of
  156. the menubar. The Menubar dialogue provides for definition of all
  157. parameters and selection of individual command sets for
  158. modification or deletion. The command set dialogue allows for
  159. specification of the bitmap/icon file, the command and  associated
  160. parameters. The file open dialogue allows for file selection.
  161.  
  162. 4.1 Menubar dialogue
  163.  
  164. The fields on this dialogue allow for complete definition of a
  165. single menubar. They include size, position, number of items per
  166. row, and close options. Individual commands activate the command
  167. set dialogue or operate on command sets.
  168.  
  169. 4.1.1 ROW
  170.  
  171. Entry to this edit box is the row location in pixels of the upper
  172. left hand corner of the menubar.
  173.  
  174. 4.1.2 COLUMN
  175.  
  176. Entry to this edit box is the column location in pixels of the
  177. upper left hand corner of the menubar.
  178.  
  179. 4.1.3 HEIGHT
  180.  
  181. Entry to this edit box is the height in pixels of the menubar. This
  182. is a function of the number of rows of bitmaps/icons planned and
  183. the size of the icons. Bitmaps are sized within a part of the
  184. menubar. Icons are truncated if the size is insufficient. This size
  185. should be specified as (desired height of bitmap/icon+1)*(Number
  186. of rows)+9. If this field is omitted, MENUBAR calculates the height
  187. based on an individual bitmap/icon size of 32 pixels.
  188.  
  189. 4.1.4 WIDTH
  190.  
  191. This edit box is the width in pixels of the menubar. This is a
  192. function of the number of bitmaps/icons planned for a row and the
  193. size of the icons. Bitmaps are sized within a part of the menubar.
  194. Icons are truncated if the size is insufficient. This size should
  195. be specified as (desired width of bitmap/icon+1)*(Number of items
  196. per row)+9. If this field is omitted, MENUBAR calculates the width
  197. based on an individual bitmap/icon size of 32 pixels.
  198.  
  199.  
  200. 4.1.5 Items per row
  201.  
  202. This edit box is the is the number of bitmaps/icons to place on
  203. each row. This is a required field. Multiple rows are created when
  204. the number of command sets exceeds this value.
  205.  
  206. 4.1.5 Close Menu
  207.  
  208. Selection of this button indicates that the menubar is to be closed
  209. after execution of a valid command.
  210.  
  211. 4.1.6 Command Sets
  212.  
  213. This list box displays the currently defined command sets. Each set
  214. is described in terms of the bitmap/icon file name, followed by the
  215. command file and parameters. Individual actions against command
  216. sets are at the bottom of the list box are discussed below.
  217.  
  218. 4.1.6.1 ADD command
  219.  
  220. This button activates the command set dialogue to create a new
  221. command entry following the currently selected entry in the list
  222. box.
  223.  
  224. 4.1.6.2 MODIFY command
  225.  
  226. This button activates the command set dialogue to modify the
  227. currently selected entry in the list box.
  228.  
  229. 4.1.6.3 DELETE command
  230.  
  231. This button deletes the currently selected entry in the list box.
  232.  
  233. 4.1.6.4 CANCEL command
  234.  
  235. This button exits the edit/create processing without changing the
  236. definition.
  237.  
  238. 4.1.6.5 OK command
  239.  
  240. This button exits the edit/create processing after changing the
  241. definition.
  242.  
  243. 4.2 Command Set dialogue
  244.  
  245. The command set dialogue contains fields to modify/create an
  246. individual command set consisting of a bitmap/icon file, a command
  247. file, and a set of parameters. Select buttons are provided to
  248. utilize the file open dialogues for selecting the files.
  249.  
  250. 4.2.1 Bitmap/Icon file
  251.  
  252. Entry to this edit box specifies the graphic file name to be
  253. displayed as the command identification on the menubar. This may
  254. be a standard windows icon (.ICO) or bitmap (.BMP) file. The SELECT
  255. button may be utilized to display the file selection dialogue for
  256. specifying the filename.
  257.  
  258. 4.2.2 Command 
  259.  
  260. Entry to this edit box specifies the command to be executed by
  261. selection on the menubar. This may be any executable file that may
  262. be run under windows. The SELECT button may be utilized to display
  263. the file selection dialogue for specifying the filename.
  264.  
  265. 4.2.3 Parameters
  266.  
  267. Entry to this edit box is for specification of the parameters
  268. associated with the command to be executed. The shareware version
  269. only allows for specification as part of the menubar definition.
  270.  
  271. 4.2.4 Select
  272.  
  273. This button is utilized to display the file selection dialogue for
  274. specifying any  filename.
  275.  
  276. 4.3 File Select Dialogue
  277.  
  278. This dialogue allows for selection of a file by browsing through
  279. directories and/or specification of portions of the filename. A
  280. default extension and prompt is provided for each type of file.
  281.  
  282.  
  283.  
  284. 5.0 Mouse/key Usage
  285.  
  286. The user may utilize either a mouse or the keyboard to execute
  287. commands, minimize the menubar or close the menubar. 
  288.  
  289. When using the mouse, three actions occur as a result of the mouse
  290. (left button) being clicked depending on the selection made.
  291. Selecting a bitmap/icon executes the command. Selecting the menubar
  292. border or any selection with the SHIFT key depressed closes the
  293. menubar. Any selection with the CONTROL key depressed minimizes the
  294. menubar. If the bar is minimized, a double click restores it to the
  295. original position.
  296.  
  297. Alternately, the keyboard may be utilized. The ARROW keys are
  298. utilized to select individual command sets. Entry of a SPACEBAR or
  299. ENTER key executes the selected command. The ESCAPE key terminates
  300. the menubar.
  301.  
  302.              III. REGISTRATION AND LICENSE FEES 
  303.   
  304. MENUBAR must be registered if utilized for other than
  305. evaluation purposes for a period not to exceed thirty (30) days.
  306. A separate copy is required for each PC utilized. The file
  307. menubar.frm provides a sample form to be printed and included with
  308. payment or send your name, company, and address to MRL, 1200
  309. Stonehurst Drive, Huntsville, Al, 35801. Registration using VISA/MC
  310. may also be accomplished by transmitting this form using Compuserve
  311. electronic mail to MRL at user id [73637,737].
  312.  
  313. Registration provides you with a version that includes the
  314. following:
  315.  
  316.     -    No startup or periodic messages
  317.  
  318.       -    Hardcopy users manual
  319.  
  320.     -    Additional program features including user parameter
  321.                 input at execution.
  322.  
  323.     -    90 day free consultation support
  324.  
  325.     -    Mailing list distribution of upgrades and new products
  326.  
  327. *****************************************************************
  328. This program has been developed and tested for Windows 3.0.
  329. Although Windows 3.1 is widely distributed, testing of MENUBAR on
  330. 3.1 has not been accomplished as of March 1, 1992. Should an update
  331. be required to execute under Windows 3.1 all registered users will
  332. receive this update free of charge. Delivery is dependent on
  333. availability of 3.1 software developers kit.
  334. *****************************************************************
  335. 1.  Registration Costs  
  336.   
  337. Current rates for prepaid orders (in US dollars) are as follows: 
  338.   
  339. $24.95    Single user registration/license fee.
  340.  
  341. $1.00    Additional cost for 3.5 disk.
  342.  
  343. $5.00    Per Order Shipping and Handling fee.
  344.  
  345. $3.00   MC/VISA usage handling fee.
  346.  
  347. $10.00    Purchase Order Handling (under $100.). Subject to Company
  348.           approval.
  349.  
  350. Residents of Alabama and Huntsville must add appropriate Sales 
  351. Tax.   
  352.  
  353.  
  354. The scheduled rates and charges are current as of the date of 
  355. this manual.  All fees and charges are subject to change without
  356. notice.  
  357.   
  358. Multiple Purchase registrations are available pursuant to the
  359. following schedules.  
  360.  
  361. Total Copies Registered (on one order)   Percent Discount 
  362.             ------------                  ------------  
  363.              1 to    5                             0% 
  364.  
  365.              6 to   10                            15% 
  366.   
  367.             10 to   99                            30% 
  368.    
  369.            100 to  499                            40% 
  370.            
  371.            500 to  999                            50% 
  372.  
  373.           1000 or more                            60% 
  374.  
  375. As stated herein, there are no warranties whatsoever associated 
  376. with the MENUBAR software product, and MRL is not responsible for
  377. its performance. You are the sole judge of the product's
  378. effectiveness and suitability for your particular purposes, and are
  379. given an opportunity to evaluate same via shareware distribution. 
  380.  
  381. We can only accept drafts, checks, international money orders or
  382. travelers checks payable in U. S. dollars drawn on U.S. banks. 
  383. Registration can also be paid by credit card, Visa or Master Card.
  384.  
  385. Registered users will be notified when updates and new products 
  386. are  available.  Anyone wishing to offer advice and suggestions 
  387. are most welcome to do so.  
  388.  
  389. Questions, errors, and suggestions for product improvements are 
  390. welcome, either mail these to MRL, 1200 Stonehurst Drive, 
  391. Huntsville, AL, 35801 or transmit them via Compuserve electronic
  392. mail to MRL at user id [73637,737].
  393.  
  394. Compuserve electronic mail is the quickest method of receiving
  395. response. Be sure to include: 
  396.   
  397. -       The version of the copy of MENUBAR that you are using.
  398. -    DOS and Windows versions that you are using;  
  399. -    hardware configuration (model, memory size, printer, etc.) 
  400. -    Windows or standard DOS applications that you may be running
  401.         or have loaded under Windows at the same time.
  402.